home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / utils3 / close / !Close / !Help next >
Text File  |  1995-09-23  |  4KB  |  111 lines
  1.                                     Close
  2.                                     =====
  3.      
  4. Introduction
  5. ------------
  6.    In the midst of developping an application have you ever come across the
  7. dreaded File open (or Bad buffer size if you have LongFiles) error ?
  8.    If you haven't then you obviously program very well. If, on the other
  9. hand, a crashed application can leave a thousand miscellanous files open by
  10. accident, then you might like to use this application.
  11.  
  12. Usage
  13. -----
  14.    Clicking Select on the iconbar icon will bring up a menu of currently open
  15. files. These are categorised into 7 sections :
  16.   R     Run files; those whose leafname starts !Run.
  17.   B     Boot files; those whose leafname starts !Boot.
  18.   O     Obey files; any other Obey file.
  19.   A     Font files; any file of type Font.
  20.   D     Device files; those in DeviceFS.
  21.   Ixxx  Image files; each individually catagorised.
  22.   F     Other files; anything not covered by the above.
  23.  
  24. The codes on the left indicate options which may be included in the
  25. Close$Options variable.
  26.  
  27. For example; if you wanted to see only obey files, device files and ArcFS
  28. archives you would use *Set Close$Options ODI3fb
  29.  
  30. If you wanted just the files not covered in the other sections (ie probable
  31. data files), you could use *Set Close$Options F
  32.  
  33. Note, the order of the options is the order they appear on the menu.
  34.  
  35.     
  36. How it works
  37. ------------
  38. Well, it's dull, but…
  39.  
  40. When select is clicked the file handles from 255 downwards are scanned until
  41. a gap of 8 unused file handles is found (to speed up the listing). If one of
  42. the handles is used, the OS_Args call 7 is used to find the filename; then
  43. the type of the file is checked and the correct array is added to.
  44.  
  45. Then, when the end of the handles is found, the arrays are built into menus,
  46. and finally the system variable is scanned and the top level menu is created
  47. and opened.
  48.  
  49. When clicked on, all handles with the same pathname are closed, so if you
  50. have opened a file a couple of dozen times (for read), then one click will
  51. close every instance of that file in the handles list. For speed, the menu is
  52. not updated on menu selection.
  53.  
  54.  
  55. Help and message files
  56. ----------------------
  57. This application is fully !Help compliant and it is recommended that when
  58. getting to grips with it the help should be used if only to give it some
  59. purpose! It also supports the use of MessageTrans and therefore translation
  60. to another language or changing the messages for the fun of it is much easier
  61. than it might have been.
  62.  
  63.  
  64. <BasicLibrary$File>
  65. -------------------
  66. This application requires Justin Fletcher's JFShared library to function.
  67. This can be obtained from Arcade and possibly other bulletin boards. I have
  68. seen QuickHelp on Digital Databank, so it is possible that JFShared exists
  69. there also.
  70.  
  71.  
  72. Compatibility
  73. -------------
  74. This application has been tested on the author's A5000, but due to the lack
  75. of friends with Acorns has not been tested on other systems. Therefore, it
  76. ought to work on any RO3.1 machine, and with a RO2 machine if it is
  77. recognised in JFShared and uses no specific RO3 features.
  78.  
  79.  
  80. Disclaimer
  81. ----------
  82.   The author accepts no responsibility for any problems which this
  83. application may cause or loss of data resulting in its use. This application
  84. is Public Domain. This means that it may be distributed, so long as no charge
  85. other than copying costs are charged for it.
  86.   
  87.         
  88. Contact                
  89. -------
  90. Any comments, queries, donations or bug reports can be sent to :
  91.  
  92. Fidonet NetMail :  Justin Fletcher at Arcade (0181 655 4412) [2:254/27]
  93. E-Mail : Gerph@arcade.demon.co.uk
  94.  
  95. Snail Mail :
  96.     Justin Fletcher
  97.     “Galadriel”
  98.     17b Cromwell Road,
  99.     Weeting,
  100.     Brandon,
  101.     Suffolk.
  102.     IP27 0QT
  103.  
  104.  
  105. History
  106. -------
  107. Version 1.00 : ?? ??? ????
  108.                First version written
  109. Version 1.02 : 05 Sep 1995
  110.                Added Image files support to remove great big list of
  111.                StrongHelp files which I tend to get.